home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 751-760 / 756 / popupmenu / popupmenu.doc < prev    next >
Text File  |  1995-03-18  |  8KB  |  245 lines
  1.  
  2.     PopUpMenu V5.0 by Martin Adrian           4/10 -92
  3.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.     Introduction
  6.     ~~~~~~~~~~~~
  7.     Are you using QMouse, DMouse, or HeliosMouse and "always" get the wrong
  8.      menus when you press the mousebutton?
  9.     Have you ever needed pop-up menus for your Amiga?
  10.  
  11.     The solution: PopUpMenu
  12.  
  13.     What is it ?
  14.     ~~~~~~~~~~~~
  15.     This small program makes it possible for You to use popup-menus with
  16.      all programs that uses the standard intuition menus.
  17.  
  18.     The popup-menus works just like the standard pull-down menus for both
  19.      the user (multiple selections, checkmarks, commandkeys) and the
  20.      programmer (MENUPICK and MENUVERIFY).
  21.  
  22.     Features:
  23.     ~~~~~~~~~
  24.     * The menus will not pop-up if any of the following conditions are true.
  25.  
  26.        1) The mousepointer is in the screens menubar.
  27.       (standard pull-down menus will appear)
  28.  
  29.        2) You are pressing any other mousebutton (left or middle).
  30.  
  31.     * You may select if the menus should pop-up when you are holding a
  32.       qualifier key on Your keyboard down or not.
  33.  
  34.     * Click-menus: You make Your selection with the select-button instead of
  35.            holding down the menubutton (works like I*M PC menus).
  36.            Excellent for programs with many menus (e.g. RSDemo).
  37.  
  38.     * MenuItems can be centered around the menu (To minimize mouse movements).
  39.  
  40.     * The program remembers the last menu selected.
  41.  
  42.     * PopUpMenu has an intuition interface for setting options.
  43.  
  44.     * PopUpMenu is a commodity and can be controlled from the Exchange program
  45.  
  46.     * PopUpMenu listens for CTRL-F (Open option window) and CTRL-C (exit)
  47.  
  48.     * PopUpMenu reads the icontrol prefs to get the verify Timeout.
  49.  
  50.    Starting PopUpMenu
  51.    ~~~~~~~~~~~~~~~~~~
  52.  
  53.    ----------------------   From CLI:  ------------------------
  54.    To turn on the pop-up menus just type:
  55.  
  56.      1> Run PopUpMenu  [options]
  57.  
  58.    ----------------------   From WB:   -----------------------
  59.  
  60.    Click the PopUpMenu icon.
  61.  
  62.  
  63.    If PopUpMenu is already running the option window will show up.
  64.    (All arguments are ignored)
  65.  
  66.    Options
  67.    ~~~~~~~
  68.  
  69.    - - - - - - - - - Click-menus - - - - - - - - -
  70.    CLI: CLICKMENUS        WB: CLICKMENUS
  71.  
  72.      If a program has a lot of menus it may be difficult
  73.      to select the one You want.  Click-menus lets You
  74.      slow and easy select it.
  75.  
  76.         1. Press and release the menubutton.
  77.         2. The menus will show up.
  78.         3. Select the menu You want with the selectbutton.
  79.         4. Select the menuitem or subitem in the same way.
  80.         5. You may cancel the menu selection by pressing
  81.            the menubutton again.
  82.  
  83.    - - - - - - - - Show single menu - - - - - - - -
  84.    CLI: SHOWSINGLE        WB: SHOWSINGLE
  85.  
  86.      If a window has only one menu, PopUpMenu shows it
  87.      together with the menuitems.  To disable this feature
  88.      turn this option on.
  89.  
  90.             Show single       Default
  91.               +-----+         +------+
  92.         +-----|Items|         |Menu  |
  93.         |Menu |     |         |Items |
  94.         +-----|     |         |        |
  95.               |     |         |        |
  96.               +-----+         |        |
  97.                      +------+
  98.    - - - - - - - - Centered menuitems - - - - - -
  99.    CLI: CENTERITEMS        WB: CENTERITEMS
  100.  
  101.      When PopUpMenu displays the menu-items it usually
  102.      places the top item next to the menu.    With this
  103.      option on, the items are centered around the menu.
  104.  
  105.           Default           Centered
  106.           +------+           +------+
  107.           |      |           |     +-----+
  108.           |      |           |     |Items|
  109.           |     +-----+       |     |     |
  110.           |Menu |Items|       |Menu |     |
  111.           +-----|      |       +-----|     |
  112.             |      |         |     |
  113.             |      |         +-----+
  114.             |      |
  115.             +-----+
  116.  
  117.    - - Pop-up menus when a qualifier is pressed - -
  118.    CLI: POPWITHQUAL        WB: POPWITHQUAL
  119.  
  120.      This options controls if the menus should pop-up when
  121.      a qualifier is held down.
  122.          (Qualifier = SHIFT, ALT, AMIGA, CTRL)
  123.  
  124.    - - - - - - - Open option window - - - - - - -
  125.    CLI: CX_POPUP        WB: CX_POPUP=<YES|NO>
  126.  
  127.      Open the PopUpMenu option window.
  128.      Please note difference CLI <-> WB.
  129.  
  130.    - - - - - - - - - - Set Hotkey - - - - - - - - - -
  131.    CLI: CX_POPKEY <hot key> WB: CX_POPKEY=<hot key>
  132.  
  133.      Use this option to set the hot-Key.  If the hot-key is pressed
  134.      the PopUpMenu option window will show up on the default
  135.      public screen.
  136.  
  137.    - - - - - - Set broker priority - - - - - - -
  138.    CLI: CX_PRIORITY <n>     WB: CX_PRIORITY=<n>
  139.  
  140.  
  141.    PopUpMenu option window
  142.    ~~~~~~~~~~~~~~~~~~~~~~~
  143.    If You set the CX_POPUP option, press the hot-key, selects the SHOW
  144.      gadget in the Exchange program or starts the PopUpMenu a second
  145.      time, the PopUpMenu option window will show up on the default
  146.      public screen.
  147.  
  148.      In this window You may enable or disable any option with a mouse-click
  149.      or by pressing the corresponding key.
  150.  
  151.    There are two more gadgets in the window:
  152.    Name         Key        Action
  153.    ~~~~         ~~~        ~~~~~~
  154.    Hide        Return  - Closes the window and uses the currently selected
  155.             ESC      options.
  156.  
  157.    Kill          K       - Closes window and removes PopUpMenu from memory.
  158.                  (No "Are You sure" requester will show up)
  159.  
  160.  
  161.    Differences from Intuition:
  162.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  163.    Bad:
  164.      Intuition draws the menus off-screen and then swaps them to the screen.
  165.      PopUpMenu draws the menus on the screen.    (I don't want to create a
  166.      rastport just to draw them)
  167.  
  168.    Good:
  169.      The mousepointer does not stop while menuwindows are opened or closed.
  170.      (Makes it easier to select items when your amiga has much to do)
  171.  
  172.    Good or bad ?
  173.      PopUpMenu does not remove any RAWMOUSE inputevents while the menus
  174.      are shown.  (Intuition needs these to move the mousepointer etc.)
  175.  
  176.      If a menu does not have menuitems, intuition shows a small empty
  177.      itemwindow.  PopUpMenu does not show anything at all.
  178.  
  179.    Same as Intuition:
  180.    ~~~~~~~~~~~~~~~~~~
  181.  
  182.    * PopUpMenu handles multiple selection as silly as intuition.
  183.        Don't select a menuitem more than once or the checkmarks may be moved
  184.        to the wrong item.
  185.  
  186.  
  187.    Distribution
  188.    ~~~~~~~~~~~~
  189.  
  190.    The PopUpMenu program is "Public Domain"
  191.    It may be sold, copied, distributed with any product (even commercial ones)
  192.    or included in a library.
  193.  
  194.    If You change the source please use some other name than PopUpMenu
  195.    (i.e. NewPopUpMenu, BetterPopUpMenu etc)
  196.  
  197.  
  198.    Warnings:
  199.    ~~~~~~~~~
  200.  
  201.    1. Intuition is a very big inputhandler (i think), this means that intuition
  202.      will lockup the input.device if it (intuition) tries to draw something
  203.      (i.e activate a window) on a locked screen.  This will lead to a deadlock
  204.      since my program is waiting for mouse-events from the input.device.
  205.      To walk around this I have installed a timer to go off every 0.25s, if
  206.      no inputevents has arrived in this time my program does the following:
  207.  
  208.       1. Remove all displayed menus.
  209.       2. Unlock the screen.
  210.       3. Wait for the input.device to start.
  211.       4. Lock the screen again.
  212.       5. Draw all menus again.
  213.  
  214.      This will make the menus flash once.
  215.  
  216.    2. Some programs draw directly into the screen without using the
  217.      layers.library.  Using PopUpMenu on these screens may produce strange
  218.      results.  Only the data on the screen is affected.
  219.      Programs found:  RSDemo, Imploder (4.0)
  220.  
  221.    3. PopUpMenu changes some library vectors in intuition (OnMenu,OffMenu,
  222.      ClearMenuStrip).  Use SaferPatches!!
  223.  
  224.    4. The Amiga Rom Kernal manual, Libraries, states that the menu operation is
  225.      cancelled if the MENUVERIFY times out. This is not true, the menus
  226.      shows up if the menu button is still down when the MENUVERIFY reply
  227.      comes. (The menustrip may look ugly).
  228.      PopUpMenu works like stated in the ARKM.
  229.  
  230.    FUTURE:
  231.    ~~~~~~~
  232.  
  233.    Support for the NewLook menus with scaled Amigakeys in KS 3.0.
  234.  
  235.  
  236.    Author:
  237.    ~~~~~~~
  238.      Martin Adrian
  239.      Rullharvsgatan 3A           (New addres from 1-jun-91)            ..
  240.      S-431 47  Mölndal           (the ö is an 'o' with to dots above -> o )
  241.      SWEDEN
  242.  
  243. I dont have any EMAIL address anymore
  244.  
  245.